home *** CD-ROM | disk | FTP | other *** search
/ Windows 95 Super Collection / Windows 95 Super Collection.iso / win95 / programm / winscrp / manual.txt < prev    next >
Encoding:
Text File  |  1995-05-19  |  7.2 KB  |  225 lines
  1. Window Scraper is a Trademark of Hampton Data Inc.
  2. Window Scraper is Copyright 1995 of Hampton Data.
  3. Windows is a Trademark of Microsoft Corporation, 1983-1995
  4.  
  5. Introduction
  6. =============
  7. Thank you for downloading the demo version of Window Scraper!  
  8. This program is an OLE 2 Automation enabled terminal emulator.  
  9. It was designed AS a Window Scraper, and NOT a fully featured terminal emulator.  
  10. However, it does support most of the standard 
  11. features found in most terminal emulators today.
  12.  
  13. Window Scraper enables a developer to quickly and easily develop Microsoft
  14. Windows graphical interfaces to character based applications which are running
  15. on a remote host.  Regardless of what host your character applications runs on,
  16. VAX, MVS, Unix, any remote host which is capable of a host connection using
  17. serial, TCP/IP or Netware can now have a graphical front end.  This tool
  18. will enable IS departments, and software companies to extend the life of their
  19. character based applications.
  20.  
  21. To use Window Scraper over a network, you must install COMT.  A demo version
  22. of COMt is included with Window Scraper.  COMt must be purchased separately.
  23.  
  24. Since Window Scraper uses the OLE 2 deFacto standard, the developer doesn't
  25. have to learn complicated HLLAPI's and a whole new library.  A developer
  26. can use whatever development system he or she prefers in the Windows environment.
  27.  
  28. Window Scraper works with:  Visual Basic, Visual C++, PowerBuilder, MS-Excel,
  29. MS-Access, MS-Word, and any other development system, or application capable
  30. of being an OLE Automation controller (client).
  31.  
  32. Developers now can also use a POWERFUL scripting language to handle difficult macros.   
  33. Since Window Scraper can be controlled by Visual Basic,  a developer
  34. can use Visual Basic or VBA as the terminal emulation scripting language.
  35.  
  36. Window Scraper is an ideal solution for corporate application developers who wish
  37. to add client/sever/GUI capability to their host applications.
  38.  
  39. Competing products charge as much as $300 to $1000 dollars for their products, 
  40. Window Scraper is being offered as a low introductory cost of only $39.95.  After
  41. the introduction sale is over, the price will go up.
  42.  
  43.  
  44. Features:
  45. =========
  46.  
  47.     - Runs on:  Windows 3.1, Wfw 3.1 and Windows95
  48.     - OLE 2 Automation Server
  49.     - Muliple versions capable of running simultaneously
  50.     - Emulations supported:  VT-52, VT-100, ANSI and TTY
  51.     - Kermit, XModem, YModem and Zmodem file transfer
  52.     - Session Logging
  53.     * Dialer database capable with MS-Access
  54.     * Generate GUI interfaces for character based applications
  55.     - Use VBA as terminal scripting language
  56.     * Built in CallerID support
  57.     - Works over networks:  TCP/IP, Serial, and Netware
  58.     - Build controllers with:  
  59.         Visual Basic, PowerSoft
  60.         MS-Excel, MS-Access, MS-Word
  61.     * GUI Application development tools/utilities/libraries
  62.  
  63. (* Items NOT 100% supported in DEMO version)
  64. (* entire OLE API not capable with DEMO version)
  65.  
  66. Installation
  67. ============
  68. To install Window Scraper, insert the first disk, and type a:\isntall.exe
  69.  
  70. After a successful installation, it may be necessary to regester the OLE 2.0 DLL's
  71. in your windows\system directory. To do so, run the regedit.exe program, and select
  72. the 'merge registration file' menu item.  When prompted for a file, select the
  73. file 'x:\windows\system\ole2.reg' where 'x' is your drive where windows is installed.
  74.  
  75.  
  76. Starting the program
  77. ====================
  78. Window Scraper can be launched as a stand alone application.  To start it in this
  79. mode, simply double click on the Window Scraper icon.  In this mode, no Automation
  80. capability is possible.
  81.  
  82. To launch in the Automation mode, you must make a program.  (Note:  All example
  83. source code will be in VBA (Visual Basic for Applications). 
  84.  
  85. First, you must declare a GLOBAL object variable.  If you DON'T make the object
  86. variable GLOBAL, it will loose scope at the end of your routine, and Window Scaper
  87. will terminate.
  88.  
  89. example:
  90. 'Global Variable declarations in GLOBAL.BAS
  91.  
  92. Scraper as Object
  93.  
  94. Second, in the FORM_LOAD event of the form use wish to use, add the following line:
  95.  
  96. example:
  97. sub form_load()
  98.     set Scraper = CreateObject("WindowScraper")
  99.  
  100. end sub
  101.  
  102.  
  103. From now on, you will need to reference the 'Terminal' class within the Window Scraper
  104. object.  The 'Terminal' class contains the functionally to manipulate the terminal.
  105.  
  106. Third, now, begin add code, to access the Window Scraper API.  For example, you might
  107. want to set the COM PORT, and then open it.
  108.  
  109. Example:
  110.  
  111. sub form_load()
  112.     set Scraper = CreateObject("WindowScraper")
  113.  
  114.     Scraper.Terminal.ComPort = 2    ' Set com port
  115.     Scraper.Terminal.PortOpen = TRUE ' Open the com port, TRUE should equal -1
  116.  
  117. end sub
  118.  
  119. Next, you could dial your host
  120.  
  121. example:
  122. sub form_load()
  123.     set Scraper = CreateObject("WindowScraper")
  124.  
  125.     Scraper.Terminal.ComPort = 2    ' Set com port
  126.     Scraper.Terminal.PortOpen = TRUE ' Open the com port, TRUE should equal -1
  127.  
  128.     Scraper.Terminal.Output = "ATDT555-5555" + chr$(13)
  129.                 'Dial the number 555-5555, Note: must have
  130.                                 'a character return in order execute input.
  131.  
  132. end sub
  133.  
  134. Finally, you can check to see if you are connected:
  135.  
  136.  
  137. sub form_load()
  138.     set Scraper = CreateObject("WindowScraper")
  139.  
  140.     Scraper.Terminal.ComPort = 2    ' Set com port
  141.     Scraper.Terminal.PortOpen = TRUE ' Open the com port, TRUE should equal -1
  142.  
  143.     If Scraper.Terminal.Output = "CONNECTED"    then
  144.         MessageBox "Connected"
  145.     EndIf
  146.         
  147.  
  148. end sub
  149.  
  150.  
  151. GUI Development
  152. ===============
  153. Using the Visual Basic, a developer creates a graphical form that looks similar
  154. (or dissimilar for that matter) to the character based screen.  The developer
  155. would place  text box on the form, that text box would map to a specific field
  156. on the character based screen.  The developer would also use label controls to
  157. map to field specifiers. 
  158.  
  159. The developer would need to specify, the Column, Line and length of the field.  For example,  if the screen had look like  this:
  160.  
  161.   1234567890
  162.   ----------------------------------------------------------------------------
  163. 1 |
  164. 2 |         
  165. 3 |  Name:  Larry P. Maloney
  166. 4 |  Address: XXXX Street
  167. 5 |  City
  168. 6 |
  169. 7 |
  170. 8 |
  171. 9 |
  172. 10|
  173. 11|
  174. 12|
  175. 13|
  176. 14|
  177. 15|
  178. 16|
  179. 17|
  180. 18|
  181. 19|
  182. 20|
  183. 21|
  184. 22|
  185. 23|
  186. 24|
  187. 25|
  188.   ------------------------------------------------------------------------------
  189.  
  190. The following code, could then be added to display a GUI form for this character
  191. screen:
  192.  
  193. sub button1_click()
  194.     
  195.     Label(1).Caption = Scraper.Terminal.ScreenField(4,3,4)
  196.     Text(1).Text = Scraper.Terminal.ScreenField(11,3,16)
  197.  
  198. end sub
  199.  
  200. This sample, shows but ONE of the many functions available in Window Scraper.Terminal.  Window scraper has the ability to AUTOMATICALLY find fields, WITHOUT problematically specifying them.  This feature isn't available in the demo version.
  201.  
  202.  
  203. Movement
  204. ========
  205. The most reliable method to move the cursor in Window Scraper, is to use the tab 
  206. character.  Example:
  207.  
  208.             Scraper.Terminal.Terminal.Output = chr$(9)
  209.  
  210.  
  211.  
  212. Support
  213. =======
  214. Support is NOT available for demo versions of Window Scraper.
  215. Support is available for paying users of Window Scraper.  Additional support services
  216. is available for application developers.  Please submit all support questions
  217. to your email address at window_scraper_support@hampton.hampton.com.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.